Function Reference

_TS_Wrapper_TriggerLogon

Creates a logon Trigger.

#Include <TaskScheduler.au3>
_TS_Wrapper_TriggerLogon($oTriggers, $iDelay, $sStart[, $sEnd = ""])

 

Parameters

$oTaskDefinition Task Definition object as returned by _TS_Wrapper_TaskCreate
$iDelay Value in minutes indicating the time between the users logon and the start of the Task
$sStart The date and time when the Trigger is activated. Format: YYYY-MM-DDTHH:MM:SS(+-)HH:MM. See Remarks
$sEnd [optional] The date and time when the Trigger is deactivated. Format: YYYY-MM-DDTHH:MM:SS(+-)HH:MM. See Remarks

 

Return Value

Success: Object of the created schedule
Failure: Returns 0 and sets @error
    3201 - Error returned when creating the Trigger object. @extended is set to the COM error code
    3202 - Error setting property StartBoundary. Please check the correct format as described above. @extended is set to the COM error code
    3203 - Error setting property EndBoundary. Please check the correct format as described above. @extended is set to the COM error code
    3204 - Error setting property ExecutionTimeLimit. Please check the correct format as described above. @extended is set to the COM error code
    3205 - Error setting property Delay. Please check the correct format as described above. @extended is set to the COM error code
    3206 - Parameter $oTaskDefinition is not an object or not an ITaskDefinition object
    3207 - Error returned when accessing the Triggers collection. @extended is set to the COM error code

 

Remarks

The (+-)HH:MM section describes the time zone as a certain number of hours ahead or behind Coordinated Universal Time (Greenwich Mean Time).

 

Related

 

Example


#Region ;**** Directives created by AutoIt3Wrapper_GUI ****
#AutoIt3Wrapper_Res_requestedExecutionLevel=asInvoker
#AutoIt3Wrapper_AU3Check_Stop_OnWarning=y
#AutoIt3Wrapper_AU3Check_Parameters=-d -w 1 -w 2 -w 3 -w 4 -w 5 -w 6 -w 7
#EndRegion ;**** Directives created by AutoIt3Wrapper_GUI ****

#include <MsgBoxConstants.au3>

MsgBox($MB_ICONINFORMATION, "Task Scheduler UDF", "Please check example script _TS_Wrapper_TaskCreate.au3 for an example!")